Page 1 of 9 



,™ %EST AVAILS COP 



Contents | Prev | Next ICO i f»" JT*»— ► w k " yarn Core Reflection 

The class java.lang.Oass 

package j ava . lang ; 
import j ava. lang. reflect. Field; 
import java . lang . reflect .Method; 
import java . lang . reflect . Constructor; 
public final class Class extends Object 

Instances of the class class represent Java types in a way that allows them to be manipulated by a 
running Java program. Every array also belongs to a class that is reflected as a class object that is 
shared by all arrays with the same element type and number of dimensions. Finally, the eight primitive 
Java types and void are also represented by unique class objects. 

There are no public constructors for class class. The Java Virtual Machine automatically constructs 
class objects when new classes are loaded; such objects cannot be created by user programs. 

While the class class properly belongs in the java. lang. reflect package, it remains in java. lang 
for backwards compatibility. 



Methods 

The class class is augmented with new methods to: 

• determine if a class object represents an array type 

• determine if a class object represents a primitive type 

• determine the Java language modifiers of the represented class type 

• reflect the members and constructors of the represented type 

• determine if an object is an instance of the represented class, or implements the represented 
interface 

• determine if a class or interface is a superclass or superinterface of a class or interface 

• get the component type for a represented array type 

The existing and new methods of class class are described below. 
toString 
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public String toString ( ) 

Returns a string consisting of the word class, a space, and the fully-qualified name of the class if 
this class object represents a class (either a declared class or an array class). If this class object 
represents an interface, then this method returns a string consisting of the word interface, 
followed by a space, followed by the fully-qualified name of the interface. If this class object 
represents a primitive type, then this method returns the name of the primitive type. If this class 
object represents void, returns the String "void". 

This method overrides the tostring method of class object. 
forName 

public static Class f orName ( String className) 
throws ClassNotFoundException 

Given the fully-qualified name for a class, this method attempts to locate, load, and link the specified 
class. If it succeeds, returns the class object representing the class. If it fails, the method throws a 

ClassNotFoundException. 

class objects for array types may be obtained via this method. These Class objects are automatically 
constructed by the Java Virtual Machine. 

class objects that represent the primitive Java types or void cannot be obtained via this method, 
newlnstance 

public Object newlnstance ( ) 

throws InstantiationException, I 11 egalAccess Exception 

Creates and initializes a new instance of the class represented by this class object, provided it 
represents an instantiable class. This is done exactly as if by an instance creation expression with an 
empty argument list. If evaluation of such an instance creation expression would complete abruptly, 
then the invocation of newlnstance will complete abruptly for the same reason. Otherwise, it returns 
the newly created and initialized instance. 

The method throws an niegaiAccessException if the class or initializer is not accessible to the 
calling class. The method throws an InstantiationException if it attempts to instantiate an abstract 
class or an interface, or if it is invoiced on a class object that represents a primitive type or void. 

islnstance 

public boolean islnstance {Obj ect ob j ) 

This method is the dynamic equivalent of the Java language instanceof operator. The method 
returns true if the specified object argument is non- null and can be cast to the reference type 
represented by this class object without raising a ciassCastException. It returns false otherwise. 
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If this class object represents a primitive type or void, returns false. 
See The Java Language Specification, section 15.19.2. 
isAssignableFrom 

public boolean isAssignableFrom (Class fromClass) 

This method tests whether the type represented by the specified class parameter can be converted to 
the type represented by this class object via an identity conversion or via a widening reference 
conversion. It returns true if so, false otherwise. 

If this class object represents a primitive type, returns true if the specified class parameter is 
exactly this class object, false otherwise. 

This method throws a NuiiPointerException if the specified class parameter is null. 

See The Java Language Specification, sections 5. LI, 5.1.4 and 5.2. 

islnterface 

public boolean islnterface ( ) 

If this class object represents an interface type, returns true, otherwise returns false. 
isArray 

public boolean isArray() 

If this class object represents an array type, returns true; otherwise returns false. 
isPrimitive 

public boolean isPrimitive ( ) 

If this class object represents a primitive Java type, returns true; otherwise returns false. 

There are nine predefined class objects that represent theprimitive Java types and void. These are 
created by the Java Virtual Machine, and have the same names as the primitive types that they 
represent. These objects may only be accessed via the following public static final variables: 

j ava . lang . Boolean . TYPE 
j ava . lang . Character . TYPE 
j ava . lang . Byte . TYPE 
java. lang. Short. TYPE 
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j ava . lang . Integer . TYPE 
j ava . lang . Long . TYPE 
j ava . lang . Float . TYPE 
j ava . lang . Double . TYPE 
j ava . lang . Void . TYPE 

These are the only class objects for which this method returns true. 
getName 

public String getName ( ) 

Returns the fully-qualified name of the class (declared or array), interface, primitive type or void 
represented by this class object, as a string. 

getModifiers 

public int getModifiers ( ) 

Returns the Java language modifiers for this class or interface, encoded in an integer. The modifiers 
consist of the Java Virtual Machine's constants for public, protected, private, final, and 
interface; they should be decoded using the methods of class Modifier. 

The modifier encodings are defined in The Java Virtual Machine Specification, table 4.L 
getClassLoader 

public ClassLoader getClassLoader ( ) 

Returns the class loader object that loaded this class. Returns null if this class was not loaded by a 
class loader. 

getSupercIass 

public Class getSupercIass ( ) 

If this class object represents a class other than object, returns the class that represents the 
superclass of the class. Returns null if this class represents the class object, or if it represents an 
interface type or a primitive type. 

getlnterfaces 

public Class [] getlnterfaces { ) 

Returns an array of class objects representing the interfaces of the class or interface represented by 
this class object. If this class object represents a class, returns an array containing objects 
representing the interfaces directly implemented by the class. If this class object represents an 



http://java.sun.eom/products/jdk/l . 1/docs/guide/reflection/spec/java-reflection.docl .html 



2/23/01 



1 

Page5 of 9 



interface, returns an array containing objects representing the direct superinterfaces of the interface. 
Returns an array of length o if this class implements no interfaces or if it represents a primitive type. 

getComponentType 

public Class getComponentType ( ) 

If this class object represents an array type, returns the class object representing the component 
type of the array; otherwise returns null. 

getDeclaringClass 

public Class getDeclaringClass ( ) 

If this class or interface is a member of another class, returns the class object representing the class 
of which it is a member (its declaring class). Returns a null reference if this class or interface is not a 
member of any other class. 

getClasses 

public Class [] getClasses () 

Returns an array containing class objects representing all the public classes and interfaces that are 
members of the class represented by this class object. This includes public class and interface 
members inherited from superclasses and public class and interface members declared by the class. 
Returns an array of length o if the class has no public member classes or interfaces, or if this class 
object represents a primitive type. 

getFields 

public Field [] getFields ( ) 

throws SecurityException 

Returns an array containing Field objects reflecting all the public accessible fields of the class or 
interface represented by this class object, including those declared by the class or interface and those 
declared by superclasses and superinterfaces. (Thus, the array includes the public member fields of 
the class as well as any additional public hidden fields.) Returns an array of length o if the class or 
interface has no public accessible fields. 

Note that the implicit length field for array types is not reflected by this method. User code should 
use the methods of class Array to manipulate arrays. 

The method throws a SecurityException if access to this information is denied. 

See The Java Language Specification, sections 8.2 and 8.3. 

getMethods 

public Method [ ] getMethods ( ) 
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s( \ throws SecurityException 

Returns an array containing Method objects reflecting all the public member methods of the class or 
interface represented by this class object, including those declared by the class or interface and and 
those inherited from superclasses and superinterfaces. Returns an array of length o if the class or 
interface has no public member methods. 

The method throws a SecurityException if access to this information is denied. 
See The Java Language Specification, sections 8.2 and 8.4. 
getConstructors 

public Constructor [ ] getConstructors ( ) 
throws SecurityException 

Returns an array containing Constructor objects that reflect all the public constructors of the class 
represented by this class object. Returns an array of length o if the class has no public constructors, 
or if this class object represents an interface or a primitive type. 

The method throws a SecurityException if access to this information is denied. 
getField 

public Field getField ( String name) 

throws NoSuchFieldException, SecurityException 

Returns a Field object that reflects the specified public accessible field of the class or interface 
represented by this class object. The name parameter is a string specifying the simple name of the 
desired field. 

The field to be reflected is located by searching all the accessible fields of the class or interface 
represented by this class object for a public field with the specified name. 

The method throws a NoSuchFieldException if a matching field is not found. 

The method throws a SecurityException if access to the underlying field is denied. 

See The Java Language Specification, sections 8.2 and 8.3. 

getMethod 

public Method getMethod (String name, Class [] parameterTypes ) 
throws NoSuchMethodException, SecurityException 

Returns a Method object that reflects the specified public member method of the class or interface 
represented by this class object. The name parameter is a string specifying the simple name the 
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desired method, and the parameterTypes parameter is an array of class objects that identify the 
method's formal parameter types, in declared order. 

The method to reflect is located by searching all the member methods of the class or interface 
represented by this class object for a public method with the specified name and exactly the same 
formal parameter types. 

The method throws a NoSuchMethodException a matching method is not found. 

The method throws a SecurityException if access to the underlying method is denied. 

See The Java Language Specification, sections 8.2 and 8.4. 

getConstructor 

public Constructor getConstructor (Class [ ] parameterTypes) 
throws NoSuchMethodException, SecurityException 

Returns a constructor object that reflects the specified public constructor of the class represented 
by this class object. The parameterTypes parameter is an array of class objects that identify the 
constructor's formal parameter types, in declared order. 

The constructor to reflect is located by searching all the constructors of the class represented by this 
class object for a public constructor with the exactly the same formal parameter types. 

The method throws a NoSuchMethodException if a matching constructor is not found. 

The method throws a SecurityException if access to the underlying constructor is denied. 

getDeclaredClasses 

public Class [] getDeclaredClasses ( ) 
throws SecurityException 

Returns an array of class objects reflecting all the classes and interfaces declared as members of the 
class represented by this class object. This includes public, protected, default (package) access, 
and private classes and interfaces declared by the class, but excludes inherited classes and interfaces. 
Returns an array of length o if the class declares no classes or interfaces as members, or if this class 
object represents a primitive type. 

The method throws a SecurityException if access to this information is denied. 
getDeclaredFields 

public Field [] getDeclaredFields ( ) 
throws SecurityException 
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Returns an array of Field objects reflecting all the fields declared by the class or interface represented 
by this class object. This includes public, protected, default (package) access, and private fields, 
but excludes inherited fields. Returns an array of length o if the class or interface declares no fields, or 
if this class object represents a primitive type. 

The method throws a securityException if access to this information is denied. 
See The Java Language Specification, sections 8.2 and 8.3. 
getDeclaredMethods 

public Method [] getDeclaredMethods ( ) 
throws SecurityException 

Returns an array of Method objects reflecting all the methods declared by the class or interface 
represented by this class object. This includes public, protected, default (package) access, and 
private methods, but excludes inherited methods. Returns an array of length o if the class or 
interface declares no methods, or if this class object represents a primitive type. 

The method throws a SecurityException if access to this information is denied. 

See The Java Language Specification, sections 8.2 and 8.4. 

getDeclaredConstructors 

public Constructor [ ] getDeclaredCons tructors ( ) 
throws SecurityException 

Returns an array of constructor objects reflecting all the constructors declared by the class 
represented by this class object. These are public, protected, default (package) access, and 
private constructors. Returns an array of length o if this class object represents an interface or a 
primitive type. 

The method throws a SecurityException if access to this information is denied. 
getDeclaredField 

public Field getDeclaredField ( String name) 

throws NoSuchFieldException, SecurityException 

Returns a Field object that reflects the specified declared field of the class or interface represented by 
this class object. The name parameter is a string that specifies the simple name of the desired field. 

The method throws a NoSuchFieldException if a field with the specified name is not found. 

The method throws a securityException if access to the underlying field is denied. 
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Sfee The Java Language Specification, sections 8.2 and 8.3. 
getDeel a red Method 

public Method getDeclaredMethod (String name, 

Class [ ] parameterTypes) 
throws NoSuchMethodException, SecurityException 

Returns a Method object that reflects the specified declared method of the class or interface 
represented by this class object. The name parameter is a string that specifies the simple name of 
the desired method, and the parameterTypes parameter is an array of class objects that identify the 
method's formal parameter types, in declared order. 

The method throws a NoSuchMethodException if a matching method is not found. 
The method throws a SecurityException if access to the underlying method is denied. 
See The Java Language Specification, sections 8.2 and 8.4. 
getDeclaredConstructor 

public Constructor getDeclaredConstructor (Class [ ] parameterTypes) 
throws NoSuchMethodException, SecurityException 

Returns a Constructor object that reflects the specified constructor of the class or interface 
represented by this class object. The parameterTypes parameter is an array of class objects that 
identify the constructor's formal parameter types, in declared order. 

The method throws a NoSuchMethodException if a matching constructor is not found. 

The method throws a SecurityException if access to the underlying constructor is denied. 
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